Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / ds221.arc / DS_READ.ME < prev next >

Wrap

Text File | 1987-01-01 | 16.4 KB | 295 lines

DIRECTORY SCANNER PROGRAM Ver 2.21 /// Users of Ver 2.12 (and earlier) updating to Ver 2.21 MUST (repeat \\\ *** MUST) use the new version of DS_DRIVE.SYS contained herein. *** \\\ Ver 2.21 will not work correctly with older versions of DS_DRIVE.SYS /// Presents a full screen display of the directory structure of a given disk drive. The display looks like the following: █████ Drive C ███████████████████████████████ C:\DIR2 ████████████████████████ █ C:\ █ backup .exe ║ finder .com ║ guts .zzz █ █ ╟─ dir1 █ create .com ║ finder .exe ║ help .def █ █ ╟─ dir2 █ dump .asm ║ finder .obj ║ killer .com █ █ ║ ╟─ sub1 █ dump .exe ║ guts .asm ║ print .com █ █ ║ ╙─ sub2 █ dump .obj ║»guts .com« ║ qsort .exe █ █ ╙─ dir3 █ eater .bas ║ guts .exe ║ vdisk .sys █ █ █ eats ║ guts .obj ║ zoo .bas █ █ █ eatz .bat ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ ███████████████████████████████████████████████████████████████████████████████ Total: 10,456,123 │ Help=? Name ^ │ Files: 22 Used: 137,354 Tagged: 0 Used: 8 000,000 │ Free Core 146K │ ────name──── ──size── ──date─── time─ atr Free: 2,456,123 │ Disk 80% Full │ guts .com 17,123 10 Aug 85 18:30 r ------------------------------------------------------------------------------- This program consists of the following files: DS_READ.ME - This read.me file DS_DRIVE.SYS - File loaded as a device driver that reserves 10K of memory to store hard disk directory structure information. This memory area is used so that upon reactivation of "DS.EXE", repeat scanning of the disk is not needed to determine the disk directory structure. This file requires the following entry in your "CONFIG.SYS" file: DEVICE=DS_DRIVE.SYS D:C ^^^--- Drive specifier where D:C indicates only drive C will be maintained by the driver. or D:CD indicates drives C & D will be maintained by the driver. Note: Currently only a max of 2 drives may be specified. If the drive specifier is left off, the device driver will default to saving 2 drives and both must be fixed disks. If you have only 1 HD drive to save, it's highly recommended that you specify that 1 drive so that the device driver will allocate all of its reserved memory area for that one drive. It is recommended that you do not specify floppy disk drives or RAM drives here as they take little time to rescan the full drive directory structure. The above entry is required in your "config.sys" file so that upon booting your system, the file is loaded as a device driver. Upon successful booting and loading of this file you should see the following message: "DSCANNER Drv 2.21 Installed" This file is mandatory for the program to operate correctly. Without this file the DS program must seek out the entire hard disk directory structure each time the program is activated. This disk directory structure scan can take upwards of 10 seconds to accomplish on a 10M hard disk. Even longer for larger and fuller hard disks. With this file installed at boot time the DS.EXE program can maintain directory data on up to 2 drives. DS.EXE - The directory scanner program. Can be executed by typing the following: "ds" - Start program on the default drive. If the DS_DRIVE.SYS memory area has been loaded and contains directory structure information then rescanning of the disk for the directory structure info is not necessary. "ds c" - Start program with "c" drive as the first displayed drive. This format is also used if it becomes necessary to rescan the disk directory structure and avoid using possibly outdated directory structure information contained in the DS_DRIVE.SYS driver memory area. There is an option within the DS program (ALT-R) to rescan the drive and update the directory structure information so that exiting and re-entering DS with "ds c" is not necessary. DS_BKUP.EXE - The backup program which is activated from within the DS program by selecting the "b" option. This program is not a self sufficient program. It cannot be executed on its own and work properly. It expects to obtain directory structure information from the DS_DRIVE.SYS memory area. The DS_BKUP.EXE program must reside in a directory in your PATH. DS_.DOC - An abbreviated user document. DS_MOUSE.MSC - Source file for a Mouse Systems optical mouse device driver. CURRENT PROGRAM LIMITATIONS: MS/PC DOS 2.0+ Maximum number of fixed/hard disk drives supported/saved: 2 NOTE: Floppy and RAM drives are supported by the program but not saved to the ds_drive.sys area unless instructed to by a command in the config.sys file. See the discussion of the ds_drive.sys file above. Maximum number of directories per drive: 100 Maximum number of files per directory: 250 Maximum length of full pathname for any directory: 39 characters These limitations were chosen for no particular reason. The program can be recompiled extending these limitations, but with a consequent increase in the size of the program. The program currently takes up approximately 57K during execution. This does not include the backup option (which during execution takes up additional core - but releases it upon termination of the option), nor does it include the ds_drive.sys device driver which permanently reserves an area in low memory. PROGRAM BACKGROUND: The "directory scanner" program did not start out to be the DOS shell program it is now. Originally, I started out to write a hard disk backup program to enable backing up and (more importantly) restoring the hard disks on PC's located in public rooms in the Computer Science Department of the Naval Academy. The midshipmen had tendencies to add/delete files they shouldn't and occasionally even use the dreaded "format c:" command, so procedures for quick backup and restoration were necessary. As the backup program took shape I recognized it had capabilities far beyond just backup and restoring files. Development of the backup program was therefore temporarily suspended while the DOS shell program took shape. Many early suggestions for improvement came from the other instructors within the CS department. When the shell program firmed up, work was completed on the backup program and it was installed as the "b" option within the directory scanner program. The program is written primarily in "C" (90%) with a number of supporting assembly languages routines (10%) used to enhance display speed. REVISION HISTORY: Ver 2.00 - Initial public release Ver 2.10 - Added CTRL-L option to show program limits. Also added limit checks to detect excessive directories/files and inform user of problem. Offending directories/files are ignored and program continues execution. - Added ALT-F option to show free space on drives other than the current drive. - Increased stack size in an attempt to eliminate sporadic stack overflow errors in file sort routine. - Bug Fix. Copy/Move option with destination directory of only 2 or 3 characters (ie: \c or \ds) did not work correctly. Ver 2.11 (27 May 86) - Temporary patch to file sort routine stack overflow problem. - Added ALT-X option to allow execution of indicated file with I/O redirection possible. Original "X" option did not allow for redirection. - Modified DS_DRIVE.SYS device driver to allow the user to specify the drives the driver should save. This will allow users with other than fixed disks (Bernoulli boxes for example) to specify their desires. See above explanation on DS_DRIVE.SYS for proper specification of desired drives. Ver 2.12 (29 May 86) - Bug Fix to backup option introduced by Ver 2.11 where backup option listed 1 file in each directory twice and left off 1 file that was really there. Ver 2.20 (20 Dec 86) - Changed Rescan Directory option (old CTRL-D) to ALT-R option to make room for next new option. - Added CTRL-D option for Directory Modifications. Allows addition, deletion, and name changing of directories. Based on limited testing to date, name changing only appears to work for PC/MS DOS 3.0+. - Added ALT-S option for Selecting & Sorting of files within a directory. Allows the user to specify a file select filter other than the default "*.*". Also allows for sorting files up/down by filename, extension, size, date, or no sort (directory order). - Installed new sort function to rectify previous stack overflow problems with original sort routine. - Added CTRL-V option to toggle the displaying of disk volumn identifiers. Ver 2.21 (3 Jan 87) - Fixed bug in backup option. New sort routine added in version 2.20 caused backup program to crash if diskette or drive directory identified as backup destination was empty. If backup option is not used, version 2.21 is identical to version 2.20. AUTHOR: LCDR Nat Martino Pacific Missile Test Center (Code 4002) Point Mugu, CA 93042-5000 (805) 989-1390/1391 Autovon (351) Personal Biography: Sep 67 - Jun 71 Graduated from UC Berkeley with AB in Geography also commissioned an Ensign in the Navy thru NROTC. Jul 71 - Aug 73 Naval aviation basic and advanced training at Pensacola FL, Glynco GA, and Whidbey Island WA. Aug 73 - Feb 76 VAQ-132 EA-6B squadron. The Navy's tactical electronic warfare aircraft. (1st tour) Feb 76 - Dec 77 Naval Postgraduate School, Monterey CA. MS degree in computer science. Jan 78 - May 80 Office of the Chief of Naval Operations (OP-643F) Data base administrator for CNO operational readiness reports & automated support for Navy Command Center. Jun 80 - Dec 80 VAQ-129 readiness training squadron. Jan 81 - May 83 VAQ-137 EA-6B squadron. (2nd tour) May 83 - Jun 86 U. S. Naval Academy. Computer Science Instructor Jul 86 - present Pacific Missile Test Center, Pt Mugu CA. Software Support for EA-6B aircraft. As I am not requesting any financial contributions for using this program, my only gratification is that someone finds this program to be of use to them. I would request of those that do find this program to be of use the following: 1) Drop me a line so I know that someone is actually using the program. I welcome polite suggestions for improvement or indications of possible bugs. Please do not suggest adding non-essential options, as the larger this program becomes the less useful it is as a shell to run other programs. As I move about the base frequently, the surest way to contact me is by letter. If you decide to phone (which I also encourage) but can't get me and desire me to return your call, please indicate whether you're willing to accept a return collect call. I cannot afford to call long distance to all of you. As yet I do not have a modem to reach out and connect electronically to Compuserve or other boards on a regular basis, so unfortunately there is no quick and easy way to leave me a message electronically. The modem will come after I can afford buying a printer first. Sorry. 2) Write a program of your own and place it in the public domain so I can use it. 3) Remember how much you enjoy using this program and who the author is, as I may be asking you for a job in the future.